Shutdown Screensaver version 2.0 - manual installation guide

The essential binary files for Shutdown Screebsaver 2.0 are
1) ShutdownScreensaver.scr - the screensaver
2) ShutdownService - optional service for shutdown screensaver that is needed if you want
   to use it as a logon screensaver or if you want to use its "Perform Task before Shutdown"
   feature.


Additional files in this packages allows for easy "batch" install of the screensaver.
See "Install.bat" file for details. Depending on the configuration you want edit 
the Install.bat file to install screensaver for current user, all users and/or logon screensaver.


Additionally, before running Install.bat edit "Shutdown ScreenSaver.ini" file to set desired
configuration of the screensaver. (Note that Shutdown "ScreenSaver.ini" provides configuration
"per machine", not "per user" basis.)

Explanation of "Shutdown ScreenSaver.ini" settings:

shutdown_type - defines type of shutdown, possible values are:
0 - no action
1 - shutdown
2 - hibernate
3 - standby
4 - restart
5 - logo off
6 - lock workstation

force - defines whether the shutdown action is to be forced if there are running processes
that require user action to stop. Possible values are "true" or "false". True forces shutdown
action (applies only to shutdown, restart and logoff and in case of Windows Xp or earlier
also to hibernate and standby)

countdown - defines number of seconds (timer) before shutdown action commences. 

eblris - ensure battery life remaining is sufficient. If set to true the
screensaver will check for battery life time remaining and in casi it is less
than twice the countdown time, the countdown time will be set to half of battery
life time remaining.

perform_task - Possible values are "true" or "false". If "true" this means the
screensaver will try to execute task defined below under "task_job" and inform
the "Shutdown Screensaver Service" to perform shutdown after the task is completed.
Note that because shutdown is delegated to a service in such case, you need the 
Shutdown Screensaver service installed and running. Also note that "log off" and
"lock workstation" options are not compatible with this option as they cannot be
performed from within a service. 

task_job - command line of the task job to execute. The line should point to an .exe
or .bat file with parameters. Note that the target program should not expect any user
interaction (it should be typical batch/backround process). Also, for security reasons,
the process is launched from within screensaver, which mean it will run in security context
in which screensaver is run (for example it might run on the screensaver desktop, not a user
desktop). It is especially important to remember in case of logon screensaver, where logon
screensaver process has significantly reduced its priviledges for security reasons.

separate_logon_config - Possible values are "true" or "false". If you want to use
Shutdown Screensaver as both user screensaver and logon screensaver and have separate
configuration for logon screen, set this config option to true and define following settings
(meaning is analogous to their non-logon counterparts):
logon_shutdown_type
logon_force
logon_countdown
logon_eblris
logon_perform_task
logon_task_job

Note that for logon screen you will usually want logon_shutdown_type=1 (shutdown) as other
might have little sense, and some might even cause trouble. For example trying to logoff on 
logon screen can crash older version of Windows (Windows Xp and earlier).


Content of sample "Shutdown ScreenSaver.ini" file:

[Shutdown Screensaver]
shutdown_type=2
force=true
countdown=900
eblris=true
perform_task=false
task_job=

separate_logon_config=true
logon_shutdown_type=1
logon_force=true
logon_countdown=120
logon_eblris=true
logon_perform_task=false
logon_task_job=
